home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / info-service / gopher / Unix / xgopher.1.3 / Documents / Install-Customization < prev    next >
Encoding:
Text File  |  1993-04-06  |  8.1 KB  |  192 lines
  1. Customizing the Installization of Xgopher
  2. -----------------------------------------
  3. This document describes how the installer may wish to customize
  4. Xgopher when providing the service for one or more users.
  5. The installer may obtain and install additional software to support
  6. the use of some features of Xgopher.
  7.  
  8. We use the term "application defaults" as another way to refer to
  9. the resources of an application.
  10.  
  11.  
  12.  
  13. Window Manager Icon
  14. -------------------
  15.  
  16. A bitmap image is supplied in the directory ./bitmaps/xgopher.xbm
  17. which is suitable for use as a window manager icon.  Instructions for
  18. using of this file are provided in the "Customization" document.
  19. You may wish to install this file in a common location for users
  20. to find.  For example, you may want to install this file in the
  21. directory /usr/lib/X11/Xgopher/, where the help file is already
  22. stored (in many X11 installations).
  23.  
  24. If you do put the icon bitmap somewhere, you may want to modify
  25. the Xgopher man page to provide this information to the end users.
  26.  
  27.  
  28.  
  29. Image File Support
  30. ------------------
  31.  
  32. Xgopher can view image files (file of gopher type 'I').  Although
  33. there are many image file formats in use, many people use a small
  34. number of different types, with GIF format one of the most common.
  35.  
  36. This writeup is for the installer of Xgopher.  A separate document,
  37. "Customization", provides information for other users of Xgopher.
  38.  
  39. When an image file is selected for processing, Xgopher retrieves the
  40. file, then runs another program to display the image on an X display.
  41. This second program is often "xloadimage".  The installer of Xgopher,
  42. or any user, may change this to be any other program that is available.
  43. xloadimage is a particularly nice program because it will display 
  44. other file types besides GIF using heuristics to determine the type
  45. of the file.
  46.  
  47. The string "Xgopher.imageCommand:  xloadimage" shows the default setting
  48. of this resource.  Other interesting choices are:
  49.  
  50.     xloadimage                   (normal behavior, with messages output)
  51.     xloadimage -quiet            (to suppress messages from xloadimage)
  52.     xv                           (another nice gif viewer available)
  53.  
  54. xloadimage is not a part of the Xgopher distribution.  Many sites that
  55. run X already have this program installed.  If you need xloadimage,
  56. you may retrieve it by anonymous ftp from
  57.  
  58.     export.lcs.mit.edu: contrib/xloadimage.3.03.tar.Z
  59.  
  60.     (Note: the version number may change!)
  61.  
  62. this is the MIT archive of contributed X software.  At this writing,
  63. xloadimage 3.03 was the current release.
  64.  
  65.  
  66. 3270 Telnet Sessions for X Windows
  67. ----------------------------------
  68.  
  69. X3270 is an alternative to tn3270 that many people prefer.  Whereas
  70. tn3270 executes as an application within an xterm window and doesn't
  71. understand X at all, X3270 is a true X application.
  72.  
  73. This writeup is for the installer of Xgopher.  A separate document,
  74. "Customization", provides information for other users of Xgopher.
  75.  
  76. Xgopher 1.3 has been tested with each of these 3270 emulators.
  77. tn3270 is available (vendor-supplied) on most Unix systems.  X3270
  78. is publicly available software, but not supplied as a part of Xgopher.
  79.  
  80. X3270 is available by anonymous ftp from:
  81.    export.lcs.mit.edu: contrib/x3270-1.2.tar.Z
  82.  
  83. X3270 may also be acquired from the alt.sources archives:
  84.    wuarchive.wustl.edu: /usenet/alt.sources/articles: 5798.Z
  85.    wuarchive.wustl.edu: /usenet/alt.sources/articles: 5799.Z
  86.    wuarchive.wustl.edu: /usenet/alt.sources/articles: 5800.Z
  87.  
  88. I doubt that these two versions are identical.  I built the latter source
  89. on an IBM RS/6000 with virtually no change (okay, one minor syntax fix).
  90.  
  91. The IBM 3278 terminal character set and behavior is closely emulated by
  92. X3270.  Colors are used to distinguish normal, bold, and input fields.
  93. Keyboard mapping is a problem with all 3270 emulator programs; you
  94. will most likely be modifying one of the supplied keyboard maps in the
  95. X application defaults file.
  96.  
  97. For Xgopher sessions you may use either tn3270 or X3270, whichever you
  98. prefer or have access to on your system.  The default of last resort
  99. is specified in the Xgopher source file conf.h.  This is overridden by
  100. the system-installed application defaults file (usually
  101. /usr/lib/X11/app-defaults/Xgopher).  Finally, users may use whichever
  102. program they choose by modifying their own X resource values.
  103. (And REALLY FINALLY, the telnet and tn3270 commands may be modified
  104. during an Xgopher session by an options panel selection!)
  105.  
  106. The usual Xgopher command to start tn3270 is:
  107.     xterm -e tn3270     or     aixterm -e tn3270 (for IBM AIX systems)
  108.  
  109. If you choose X3270 instead, the command is:
  110.     x3270
  111.  
  112.  
  113.  
  114. Better Scrollbars
  115. -----------------
  116.  
  117. There is a modified scrollbar available for the Athena widget library
  118. that gives much better scrollbars than the standard Athena widget library
  119. does.  This improved scrollbar has arrow heads at each end of the bar
  120. that you can click to scroll up or down in addition to other scrollbar
  121. dragging actions for scrolling.  It is amazing how much these arrows add
  122. to the user interface.
  123.  
  124. This scrollbar widget was developed by Mitch Trachtenberg, bases on
  125. the Athena scrollbar widget and should be "plug compatible".
  126. However, it is not easy for me to support this widget directly in
  127. Xgopher.  The reason is that many computer systems have their
  128. Athena widget library generated as a shared object, or otherwise
  129. have the library already internally linked.  So, even if I provide
  130. the new scrollbar source file, and load it, the other Athena widgets
  131. (text and viewport) are already closely tied to the supplied scrollbar
  132. and will not use the new one.  The only sure way to use this new
  133. scrollbar is to re-build your Athena widget library using the 2 new
  134. files supplied by Mitch Trachtenberg.  It is okay to just re-archive
  135. your old ".o" files for Xaw.
  136.  
  137. I cannot support the use of this package, but I have tested it with 
  138. Xgopher on an IBM RS/6000, and really appreciated the appearance and
  139. behavior.  For those installers who feel like building a new Athena
  140. widget library, I recommend this scrollbar.
  141.  
  142. The shar file is available by anonymous ftp from:
  143.     
  144.     export.lcs.mit.edu: contrib/Xaw.Scrollbar.mta
  145.  
  146.  
  147.  
  148. Other Athena-Compatible Widgets
  149. -------------------------------
  150.  
  151. There is a 3-D version of the Athen widget library from
  152. kaleb@jpl-devvax.jpl.nasa.gov, also available on the X11 ftp site:
  153.  
  154.     export.lcs.mit.edu: contrib/Xaw-0.5.tar.Z
  155.  
  156. (That's the version current as of this writing at the end of 1992.)
  157.  
  158. It is "plug-compatible" with the standard Athena widget library.
  159. You can obtain this 3D version, compile it, (possibly install it,) and
  160. link Xgopher with this library instead of your system Xaw library.
  161.  
  162. I cannot support the use of this package, but I have tested it with
  163. Xgopher on an IBM RS/6000.  Especially when using color, there is some
  164. interesting visual effect, but I don't consider the added value
  165. significant enough to recommend using the 3D library.  Much of the
  166. problem stems from the fact that the Athena widgets are not beautiful.
  167. They were intended by the X consortium to be an example widget set, not
  168. necessarily a production one, and it shows (in any number of dimensions).
  169.  
  170.  
  171. There is also supposed to be a "vi" (editor) compatible version of the
  172. Athena text widget available.  I have not tested this widget.  I do not
  173. particularly recommend its use with Xgopher because  Xgopher
  174. is primarily a text display system rather than a text editing system.
  175. So the most you can gain is some familiar way to navigate a displayed
  176. text file.  However, you accomplish much of this by setting the
  177. key translations in the resource file for the existing text widget.
  178. The same installation considerations discussed above for the scrollbar
  179. replacement will be applicable to this replacement text widget.
  180. Here is the introductory paragraph from its distribution:
  181.  
  182.     This is a modified version of the X11R5 Text Widget.  It is designed
  183.     to drop into the X11R5 source tree and replace the original X11R5
  184.     Text Widget.  It will behave identically to the original, unless
  185.     the resource startMode is set to "vi", in which case it will give
  186.     you vi-like modal editing.  By Eric Bina.
  187.  
  188.     On export.lcs.mit.edu (00-index.txt):
  189.       -rw-rw-rw-  1 ftp         95091 Oct 22  1991 ViText.tar.Z
  190.  
  191.  
  192.